--------------------------------------------------------------------------------
IMPORTANT                    READ BEFORE INSTALLING                    IMPORTANT
--------------------------------------------------------------------------------
Duvelske's WPM hack must be installed before this hack can be installed.  If WPM
is not installed, you will not be able to use this hack.  The current version of
this hack was developed and tested using WPM 1.0.8 for phpBB 2.x.  That would be
the wpm108\phpbbwpm\WPM108.txt file when the WPM download is unpacked.  It
should work fine with WPM 1.0.9 and 1.0.10 as well.


If you need support or have questions during the installation process, please
check the Mini FAQ section of the readme.txt file.  Many of the more common
questions have already been answered there.
--------------------------------------------------------------------------------
                            PRE-INSTALL INSTRUCTIONS
--------------------------------------------------------------------------------

Before continuing with the installation of this hack, you should complete this
checklist:
[ ] Do you have a previously installed version of this hack on your forum?
      - If you intend to upgrade from an older version to this version, then you
        should use the upgrade instructions in upgrade.txt instead of the
        instructions below, unless otherwise noted in that file.
      - If you intend to downgrade from a higher level version, uninstall that
        version first.
[ ] Are you installing this hack on a phpBB package that has been modified, has
    non-subSilver templates installed, or is a different version than the one
    official supported?
      - You may have some trouble with some of the installation instructions,
        especially if code you are told to FIND has	already been changed.  Try
        searching for partial lines using key words or characters.
[ ] Are you installing this hack on a phpBB port, such as the one for PHP Nuke?
      - The installation instructions are written for use with an unmodified
        version of the original phpBB, which can be obtained from www.phpbb.com.
        They may or may not work with ports of phpBB.  As the author of this
        hack, I may not be able to provide support for it when installed on a
        phpBB port.

--------------------------------------------------------------------------------
                           INSTALLATION INSTRUCTIONS
--------------------------------------------------------------------------------

To install this hack on a phpBB forum, follow these steps.

1) If you have not done so already, unpack ZIP file you have downloaded.  This
   will create new directories and files as described the readme.txt file.

   But, you've probably already done this step since you're reading this file,
   right?

2) This hack adds some new files to your forum.  At this point, you should
   upload the files in hack_files.  Maintain the directory structure in
   hack_files, while considering it equivalent to the phpBB root directory.
   That means that files in hack_files/admin/ should be place in your forum's
   admin/ directory, and so on.  If directories found in hack_files do not exist
   on your forum, create matching directories on your forum as needed.

   Special Notes on this Step:
     - The upload procedure is the same as the COPY command mentioned in
       file_edits.txt and is duplicated here due to the number of people that
       never understand the COPY command.  You only need to copy/upload once.
     - If you do not have the subSilver template installed, then you do not need
       to copy any hack_files/templates/subSilver files to a subSilver directory
       on your forum.
     - If you have non-subSilver templates installed, do be sure to copy the
       hack_files/templates/subSilver files to the directories of all templates.

3) In this step, you will prepare to edit your previously existing forum files.
   All of the instructions for doing this are listed in the file_edits.txt file.
   Open this file in your favorite text editor, such as Notepad, Wordpad,
   PHPEdit, or EditPlus.  If you use Dreamweaver for this step, be CERTAIN that
   you have activated the "Code" mode of that program, or you will have problems
   later.

   Check the file for an Author's Notes section near the top for any special
   instructions that you may need to follow.  If there are none, or no Author's
   Notes at all, look near the top for a section labeled "Files To Edit."  This
   is a list of the files you'll be editing.  Obvious, huh?  Before you do
   anything else, make certain you have two local copies of each of these files.
   One copy is for editing and the other is for a backup of the unchanged file.
   If there is a problem later, you can restore the backup file(s) as needed.  
   If you don't have two local copies, make them.  When you don't have *any*
   local copies, download a copy from your web site via FTP, SSH, or another
   file transfer method.

   Special Note on this Step:
     - The local copy of the file(s) you're editing should NOT be the actual
       files being used on your site.  An exact copy of them, yes, but not the
       real thing.  Changes should not be appear on your site as you edit the
       files.

4) There was a "premodded" directory created during Step 1. If the version.txt
   file in that directory contains the version number of your phpBB
   installation, do this step.  If not, skip to the next step.

   Determine if you have previously made any changes to each of the files in
   the Files To Edit list.  When using a pre-hacked or ported phpBB package,
   that counts as having changed all files for the purpose of this step.  If
   you have not edited some of the listed files, then you can find the matching
   file in the premodded directory and replace your local editing file with the
   premodded file.  This allows you to skip editing the file in the next step.

5) If you skipped Step 4, or there are any files in the "Files to Edit" list
   that you did not replace in Step 4, then you now need to edit your local
   copy of each file in said list.  The instructions for editing these files are
   stored in file_edits.txt.  If you do not understand the format used, check
   the Mini FAQ in readme.txt.

   Finish this step up by uploading the edited version of the files to your web
   site.

   Special Note on this Step:
     - If you have non-subSilver templates installed, remember that you need to
       adapt the subSilver file instructions for editing those templates.  The
       features of this hack will not be available on other templates until they
       are edited appropriately.

6) The files in the hack_install directory are used to modify your forum's
   database as needed to use this hack.  In order to use these files, you will
   need to go to your forum and log in using an Administrator account.  Do not
   allow the session for this log in to expire until installation of the hack
   is completed.

   It is also recommended that you make a full backup of your forum's database,
   or at least any database tables that will be affected by this hack, for easy
   recovery if there is a problem later.


   Upload the hack_install directory, and all files in it, to your forum's
   root directory.  For detailed instructions, see the similar procedure in Step
   2.  Run the installer file by using your web browser to go to the
   hack_install/install.php file that is now on your web site.  This will walk
   you through several steps in which the installer will try to add database
   changes.  Make a note of any error messages, as they may mean you need to do
   some manual database changes yourself later.

   When finished, be sure to delete the hack_install directory and all files
   inside it from your server.  Leaving these files in place presents a possible
   security risk.  Bad mojo!

   Special Note on this Step:
     - If the installer tells you that you need to be log in again and
       attempting to do so results in an error message, you may have to restore
       your backups of any files mentioned in the error message in order to log
       in.  You can always upload the edited versions of those files again
       later.

7) That's it, you're officially done.

8) This is an optional step.
   If the hack has an .hl file in the docs/ directory, you may be able to use
   that.  If you don't know how to use it or what an .hl file is, check the
   Mini FAQ in readme.txt.